package com.logos.musicframe.service;

import com.logos.musicframe.entity.Users;
import com.logos.musicframe.req.UsersReq;
import com.logos.musicframe.resp.UsersResp;

/**
 * 用户信息表(Users)表服务接口
 *
 * @author rose
 * @since 2025-06-01 21:06:01
 */
public interface UsersService {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    UsersResp queryById(Integer id);

    /**
     * 新增数据
     *
     * @param users 实例对象
     * @return 实例对象
     */
    Users insert(Users users);

    /**
     * 修改数据
     *
     * @param users 实例对象
     * @return 实例对象
     */
    Users update(Users users);

    /**
     * 通过主键删除数据
     *
     * @param id 主键
     * @return 是否成功
     */
    boolean deleteById(Integer id);

    /**
     *  登录
     * @param usersReq
     * @return
     */
    UsersResp login(UsersReq usersReq);

    /**
     *  注册
     * @param usersReq
     * @return
     */
    Boolean register(UsersReq usersReq);
    
    /**
     * 更新用户信息
     * @param usersReq 用户信息请求对象
     * @return 是否更新成功
     */
    Boolean updateUserInfo(UsersReq usersReq);
    
    /**
     * 绑定手机号
     * @param usersReq 包含手机号和验证码的请求对象
     * @return 是否绑定成功
     */
    Boolean bindPhone(UsersReq usersReq);
    
    /**
     * 发送手机验证码
     * @param phone 手机号
     * @return 是否发送成功
     */
    Boolean sendPhoneCode(String phone);
    
    /**
     * 获取最近发送的验证码（仅用于演示）
     * 注意：实际项目中不应该有这个方法，这会导致安全问题
     * @param phone 手机号
     * @return 验证码
     */
    String getLastSentCode(String phone);
}
